Frequently Asked Questions

 

Q1: Will program runtime information be logged? Where are the logs stored?
A:

There are two types of logs: SuperMap iDesktopX log and SuperMap iObjects log, recording desktop and component runtime information respectively. Log contents include output info from program output window, exception messages, etc. Logs are stored in the "log" folder under the "bin" directory at the root path.

Q2: Why does using Oracle data source through desktop on Linux system prompt failure when opening or creating?
A: This occurs due to unset Oracle environment variables. Solution: Before starting SuperMap iDesktopX, temporarily set Oracle client to environment variables in Terminal. For example, set environment variables through profile file by writing these commands and executing source profile in Terminal:

  #!/bin/bash   export ORACLE_HOME=/opt/oracleClient (client path)   export PATH=$PATH:$ORACLE_HOME   export LD_LIBRARY_PATH=$ORACLE_HOME:$LD_LIBRARY_PATH

After setting Oracle client environment variables, restart SuperMap iDesktopX in the same Terminal to use Oracle data source normally. To create or connect Oracle data source, configure Oracle client in runtime environment by adding client to LD_LIBRARY_PATH. A profile example can be provided. tnsnames.ora configuration can be omitted if using EZConnect connection.

Q3: Which version of iObjects Java does the project use? Why can't the develop branch on OSCHINA compile with latest iObjects from official website?
A:

The develop branch source code depends on unreleased iObjects Java under development. Users cannot obtain the newest iObjects version, causing compilation errors. Users should checkout fixed version source code from Tags and download corresponding iObjects Java version from SuperMap official website for compilation.

Q4: Failed to start idesktopx with "License check failed, please confirm license installation" prompt.
A:

Three possible reasons: 1. No license configured 2. License configuration failed 3. License expired. For first two cases, reconfigure license. Configuration methods differ between Windows and Linux, refer to license configuration in Windows Configuration Guide and Linux Configuration Guide.

Q5: Why does starting SuperMap iDesktopX on SUSE Linux Enterprise 11 SP2 report "libSuGraphicsQT.uge:undefined symbol:_ZN40GDC170gdcUnicodeStringC1EPKw" error?
A:

SUSE requires third-party database clients to load sdx data engines correctly. One sdx loading failure affects others, causing data source opening failure or program startup failure. sdx engines requiring third-party clients: libSuEngineSRDB.sdx, libSuEngineOracle.sdx, libSuEngineDMCI.sdx, libSuEngineOsp.sdx, libSuEngineAltibase.sdx, libSuEngineDB2.sdx, libSuEngineKDB.sdx. Example: For Oracle data source, install Oracle client first, then delete all *.sdx files except libSuEngineOracle.sdx before starting SuperMap iDesktopX. Similar handling applies to other database engines.

Solution: Keep libSuEngineImagePlugin.sdx and required database engine files in bin directory, remove unnecessary *.sdx files (from above list).

Q6: Exceptions thrown during code compilation and execution.
A:

Code on git has two branches: master and develop. Master is stable release branch. Develop is daily development branch which may contain unstable code. Therefore, develop version might throw exceptions.

Q7: Why do interface fonts display as squares when running SuperMap iDesktopX on Linux system?
A:

This is caused by missing Chinese fonts in Linux system. Place a Chinese font in jre/jre/lib/fonts folder under product package directory to resolve interface display issues.

Q8: Text label display exception in maps under Linux system.
A:

Special fonts like "microsoft yahei" used in visualization might be missing in Linux, causing annotation display issues. Download fonts from attachments fonts_1.zip and fonts_2.zip, extract to "root directory/support/fonts/" (create if nonexistent). Add SUPERMAP_ROOT environment variable pointing to "root directory/support/". Configure environment following 《SuperMap iDesktopX 8C Extension Development Guide.doc》 for normal text display.

Q9: Preview image display exception in browser when publishing map service with Chinese name on Linux system without Chinese locale.
A:

For Linux systems without Chinese locale, either use English map names when publishing services, or publish Chinese-named map services on Linux systems with Chinese locale.

Q10: Starting idesktopx reports "java.lang.UnsatisfiedLinkError: /opt/SuperMap_iDesktop_Java_8.1.1_bin_linux64/bin/ libWrapjGeo.so: /usr/lib64/libstdc++.so.6: version `GLIBCXX_3.4.9' not found (required by ./bin/ libSuToolkit.so)" error
A:

Copy "libstdc++.so.6" file from product package's support folder to component's Bin directory to resolve.

Q11: On centos5.7 system, SecureCRT.exe terminal only shows command line without GUI when remotely accessing server, cannot start idesktopx.
A:

Desktop requires GUI libraries. Ensure remote server has GUI configured. Replace SecureCRT (command-line tool) with visualization tools like VNC or XManager. Refer to centos 5.5 vnc configuration and VNC installation guide for configuration.

Note: Apply same solution if encountered on other Linux systems.

Q12: Why do some features (e.g., color modification, layout template saving) fail when SuperMap iDesktopX is installed in system directories like C:\Program Files?
A:

Features requiring write access to installation path fail due to insufficient permissions. Right-click SuperMap iDesktopX.exe and select "Run as administrator" to resolve.

Q13: Why can't SuperMap iDesktopX open data from system directories or save files to them?
A:

Insufficient permissions for system directory access. Solutions:

  • Use non-system directories for data storage (recommended)
  • Right-click SuperMap iDesktopX.exe and select "Run as administrator"
  • Modify exe properties to grant administrator privileges
Q14: Failed to start SuperMap iDesktopX on Windows with error.log showing "installation path\SuperMap iDesktopX\bin\WrapjGeo.dll: The specified program could not be found".
A:

Missing Microsoft Visual C++ runtime. Install vcredist110_x64.exe from product package\SuperMap\SuperMap iDesktopX\support folder (Microsoft Visual C++ 2012) to resolve.

Q15:

How to resolve DLL loading error when starting SuperMap iDesktopX on Windows Server?

A:

Solutions:

  1. Restart SuperMap iDesktopX
  2. If error persists, modify "<loadDll loadDll="true"/>" to "False" in product package\configuration\SuperMap.Desktop.Parameter.xml
  3. Restart application
Q16: How to resolve startup failure on centos5.7 with jre version older than 1.7?
A:

SuperMap iDesktopX requires jre 1.7+. Solutions:

  • Upgrade local jre to 1.7+
  • Modify startup.sh: Change "export PATH=$SUPERMAP_ROOT:$LD_LIBRARY_PATH:$JRE_PATH:$PATH" to "export PATH=$JRE_PATH:$SUPERMAP_ROOT:$LD_LIBRARY_PATH:$PATH"

Note: Fixed in 9D version.